home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / CIncludes / MixedMode.h < prev    next >
Encoding:
C/C++ Source or Header  |  1996-05-01  |  18.1 KB  |  521 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        MixedMode.h
  3.  
  4.      Contains:    Mixed Mode Manager Interfaces.
  5.  
  6.      Version:    Technology:    System 7.5
  7.                  Release:    Universal Interfaces 3.0d3 on Copland DR1
  8.  
  9.      Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10.  
  11.      Bugs?:        If you find a problem with this file, send the file and version
  12.                  information (from above) and the problem description to:
  13.  
  14.                      Internet:    apple.bugs@applelink.apple.com
  15.                      AppleLink:    APPLE.BUGS
  16.  
  17. */
  18. #ifndef __MIXEDMODE__
  19. #define __MIXEDMODE__
  20.  
  21. #ifndef __TYPES__
  22. #include <Types.h>
  23. #endif
  24.  
  25. #ifdef __cplusplus
  26. extern "C" {
  27. #endif
  28.  
  29. #if PRAGMA_IMPORT_SUPPORTED
  30. #pragma import on
  31. #endif
  32.  
  33. #if PRAGMA_ALIGN_SUPPORTED
  34. #pragma options align=mac68k
  35. #endif
  36.  
  37. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  38. /* Mixed Mode constants */
  39. /* Current Routine Descriptor Version */
  40.  
  41. enum {
  42.     kRoutineDescriptorVersion    = 7
  43. };
  44.  
  45. /* MixedModeMagic Magic Cookie/Trap number */
  46.  
  47. enum {
  48.     _MixedModeMagic                = 0xAAFE
  49. };
  50.  
  51. /* Calling Conventions */
  52. typedef unsigned short CallingConventionType;
  53.  
  54. enum {
  55.     kPascalStackBased            = 0,
  56.     kCStackBased                = 1,
  57.     kRegisterBased                = 2,
  58.     kD0DispatchedPascalStackBased = 8,
  59.     kD1DispatchedPascalStackBased = 12,
  60.     kD0DispatchedCStackBased    = 9,
  61.     kStackDispatchedPascalStackBased = 14,
  62.     kThinkCStackBased            = 5
  63. };
  64.  
  65. /* ISA Types */
  66. typedef SInt8 ISAType;
  67.  
  68. enum {
  69.     kM68kISA                    = 0,
  70.     kPowerPCISA                    = 1
  71. };
  72.  
  73. /* RTA Types */
  74. typedef SInt8 RTAType;
  75.  
  76. enum {
  77.     kOld68kRTA                    = 0 << 4,
  78.     kPowerPCRTA                    = 0 << 4,
  79.     kCFM68kRTA                    = 1 << 4
  80. };
  81.  
  82. #if GENERATINGPOWERPC
  83. #define        GetCurrentISA()        ((ISAType) kPowerPCISA)
  84. #define        GetCurrentRTA()        ((RTAType) kPowerPCRTA)
  85. #else
  86. #define        GetCurrentISA()        ((ISAType) kM68kISA)
  87. #if GENERATINGCFM
  88. #define        GetCurrentRTA()        ((RTAType) kCFM68kRTA)
  89. #else
  90. #define        GetCurrentRTA()        ((RTAType) kOld68kRTA)
  91. #endif
  92. #endif
  93. #define        GetCurrentArchitecture()    (GetCurrentISA() | GetCurrentRTA())
  94. /* Constants for specifing 68k registers */
  95.  
  96. enum {
  97.     kRegisterD0                    = 0,
  98.     kRegisterD1                    = 1,
  99.     kRegisterD2                    = 2,
  100.     kRegisterD3                    = 3,
  101.     kRegisterD4                    = 8,
  102.     kRegisterD5                    = 9,
  103.     kRegisterD6                    = 10,
  104.     kRegisterD7                    = 11,
  105.     kRegisterA0                    = 4,
  106.     kRegisterA1                    = 5,
  107.     kRegisterA2                    = 6,
  108.     kRegisterA3                    = 7,
  109.     kRegisterA4                    = 12,
  110.     kRegisterA5                    = 13,
  111.     kRegisterA6                    = 14,                            /* A7 is the same as the PowerPC SP */
  112.     kCCRegisterCBit                = 16,
  113.     kCCRegisterVBit                = 17,
  114.     kCCRegisterZBit                = 18,
  115.     kCCRegisterNBit                = 19,
  116.     kCCRegisterXBit                = 20
  117. };
  118.  
  119. typedef unsigned short registerSelectorType;
  120. /* SizeCodes we use everywhere */
  121.  
  122. enum {
  123.     kNoByteCode                    = 0,
  124.     kOneByteCode                = 1,
  125.     kTwoByteCode                = 2,
  126.     kFourByteCode                = 3
  127. };
  128.  
  129. /* Mixed Mode Routine Records */
  130. typedef unsigned long ProcInfoType;
  131. /* Routine Flag Bits */
  132. typedef unsigned short RoutineFlagsType;
  133.  
  134. enum {
  135.     kProcDescriptorIsAbsolute    = 0x00,
  136.     kProcDescriptorIsRelative    = 0x01
  137. };
  138.  
  139.  
  140. enum {
  141.     kFragmentIsPrepared            = 0x00,
  142.     kFragmentNeedsPreparing        = 0x02
  143. };
  144.  
  145.  
  146. enum {
  147.     kUseCurrentISA                = 0x00,
  148.     kUseNativeISA                = 0x04
  149. };
  150.  
  151.  
  152. enum {
  153.     kPassSelector                = 0x00,
  154.     kDontPassSelector            = 0x08
  155. };
  156.  
  157.  
  158. enum {
  159.     kRoutineIsNotDispatchedDefaultRoutine = 0x00,
  160.     kRoutineIsDispatchedDefaultRoutine = 0x10
  161. };
  162.  
  163. #endif
  164. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  165.  
  166. enum {
  167.     kProcDescriptorIsProcPtr    = 0x00,
  168.     kProcDescriptorIsIndex        = 0x20
  169. };
  170.  
  171. struct RoutineRecord {
  172.     ProcInfoType                     procInfo;                    /* calling conventions */
  173.     SInt8                             reserved1;                    /* Must be 0 */
  174.     ISAType                         ISA;                        /* Instruction Set Architecture */
  175.     RoutineFlagsType                 routineFlags;                /* Flags for each routine */
  176.     ProcPtr                         procDescriptor;                /* Where is the thing we’re calling? */
  177.     UInt32                             reserved2;                    /* Must be 0 */
  178.     UInt32                             selector;                    /* For dispatched routines, the selector */
  179. };
  180. typedef struct RoutineRecord RoutineRecord;
  181.  
  182. typedef RoutineRecord *RoutineRecordPtr;
  183. typedef RoutineRecordPtr *RoutineRecordHandle;
  184. /* Mixed Mode Routine Descriptors */
  185. /* Definitions of the Routine Descriptor Flag Bits */
  186. typedef UInt8 RDFlagsType;
  187.  
  188. enum {
  189.     kSelectorsAreNotIndexable    = 0x00,
  190.     kSelectorsAreIndexable        = 0x01
  191. };
  192.  
  193. /* Routine Descriptor Structure */
  194. struct RoutineDescriptor {
  195.     UInt16                             goMixedModeTrap;            /* Our A-Trap */
  196.     SInt8                             version;                    /* Current Routine Descriptor version */
  197.     RDFlagsType                     routineDescriptorFlags;        /* Routine Descriptor Flags */
  198.     UInt32                             reserved1;                    /* Unused, must be zero */
  199.     UInt8                             reserved2;                    /* Unused, must be zero */
  200.     UInt8                             selectorInfo;                /* If a dispatched routine, calling convention, else 0 */
  201.     UInt16                             routineCount;                /* Number of routines in this RD */
  202.     RoutineRecord                     routineRecords[1];            /* The individual routines */
  203. };
  204. typedef struct RoutineDescriptor RoutineDescriptor;
  205.  
  206. typedef RoutineDescriptor *RoutineDescriptorPtr;
  207. typedef RoutineDescriptorPtr *RoutineDescriptorHandle;
  208. #endif
  209. #if FOR_SYSTEM7_AND_SYSTEM8_DEPRECATED
  210. /* Macros for building static Routine Descriptors */
  211.  
  212. /* A macro which creates a static instance of a non-dispatched routine descriptor */
  213. #define BUILD_ROUTINE_DESCRIPTOR(procInfo, procedure)                                 \
  214.     {                                                                                \
  215.         _MixedModeMagic,                            /* Mixed Mode A-Trap */         \
  216.         kRoutineDescriptorVersion,                    /* version */                    \
  217.         kSelectorsAreNotIndexable,                    /* RD Flags - not dispatched */    \
  218.         0,                                            /* reserved 1 */                \
  219.         0,                                            /* reserved 2 */                \
  220.         0,                                            /* selector info */                \
  221.         0,                                            /* number of routines */        \
  222.         {                                            /* It’s an array */                \
  223.             {                                        /* It’s a struct */                \
  224.                 (procInfo),                            /* the ProcInfo */                \
  225.                 0,                                    /* reserved */                    \
  226.                 GetCurrentArchitecture(),             /* ISA and RTA */                \
  227.                 kProcDescriptorIsAbsolute |            /* Flags - it’s absolute addr */\
  228.                 kFragmentIsPrepared |                /* It’s prepared */                \
  229.                 kUseNativeISA,                        /* Always use native ISA */        \
  230.                 (ProcPtr)(procedure),                /* the procedure */                \
  231.                 0,                                    /* reserved */                    \
  232.                 0                                    /* Not dispatched */            \
  233.             }                                                                        \
  234.         }                                                                            \
  235.     }
  236.  
  237. /* a macro which creates a static instance of a fat routine descriptor */
  238. #define BUILD_FAT_ROUTINE_DESCRIPTOR(m68kProcInfo, m68kProcPtr, powerPCProcInfo, powerPCProcPtr)  \
  239.     {                                                                                \
  240.         _MixedModeMagic,                            /* Mixed Mode A-Trap */         \
  241.         kRoutineDescriptorVersion,                    /* version */                    \
  242.         kSelectorsAreNotIndexable,                    /* RD Flags - not dispatched */    \
  243.         0,                                            /* reserved */                    \
  244.         0,                                            /* reserved */                    \
  245.         0,                                            /* reserved */                    \
  246.         1,                                            /* Array count */                \
  247.         {                                            /* It’s an array */                \
  248.             {                                        /* It’s a struct */                \
  249.                 (m68kProcInfo),                        /* the ProcInfo */                \
  250.                 0,                                    /* reserved */                    \
  251.                 kM68kISA |                            /* ISA */                        \
  252.                 kOld68kRTA,                            /* RTA */                        \
  253.                 kProcDescriptorIsAbsolute |            /* Flags - it’s absolute addr */\
  254.                 kUseCurrentISA,                        /* Use current ISA */            \
  255.                 (ProcPtr)(m68kProcPtr),                /* the procedure */                \
  256.                 0,                                    /* reserved */                    \
  257.                 0,                                    /* reserved */                    \
  258.             },                                                                        \
  259.             {                                        /* It’s a struct */                \
  260.                 (powerPCProcInfo),                    /* the ProcInfo */                \
  261.                 0,                                    /* reserved */                    \
  262.                 GetCurrentArchitecture(),             /* ISA and RTA */                \
  263.                 kProcDescriptorIsAbsolute |            /* Flags - it’s absolute addr */\
  264.                 kFragmentIsPrepared |                /* It’s prepared */                \
  265.                 kUseCurrentISA,                        /* Always use current ISA */    \
  266.                 (ProcPtr)(powerPCProcPtr),            /* the procedure */                \
  267.                 0,                                    /* reserved */                    \
  268.                 0                                    /* reserved */                    \
  269.             }                                                                        \
  270.         }                                                                            \
  271.     }
  272. #endif
  273. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  274. /* Mixed Mode ProcInfos */
  275.  
  276. enum {
  277.                                                                 /* Calling Convention Offsets */
  278.     kCallingConventionWidth        = 4,
  279.     kCallingConventionPhase        = 0,
  280.     kCallingConventionMask        = 0x0F,                            /* Result Offsets */
  281.     kResultSizeWidth            = 2,
  282.     kResultSizePhase            = kCallingConventionWidth,
  283.     kResultSizeMask                = 0x30,                            /* Parameter offsets & widths */
  284.     kStackParameterWidth        = 2,
  285.     kStackParameterPhase        = (kCallingConventionWidth + kResultSizeWidth),
  286.     kStackParameterMask            = 0xFFFFFFC0,                    /* Register Result Location offsets & widths */
  287.     kRegisterResultLocationWidth = 5,
  288.     kRegisterResultLocationPhase = (kCallingConventionWidth + kResultSizeWidth), /* Register Parameter offsets & widths */
  289.     kRegisterParameterWidth        = 5,
  290.     kRegisterParameterPhase        = (kCallingConventionWidth + kResultSizeWidth + kRegisterResultLocationWidth),
  291.     kRegisterParameterMask        = 0x7FFFF800,
  292.     kRegisterParameterSizePhase    = 0,
  293.     kRegisterParameterSizeWidth    = 2,
  294.     kRegisterParameterWhichPhase = kRegisterParameterSizeWidth,
  295.     kRegisterParameterWhichWidth = 3,                            /* Dispatched Stack Routine Selector offsets & widths */
  296.     kDispatchedSelectorSizeWidth = 2,
  297.     kDispatchedSelectorSizePhase = (kCallingConventionWidth + kResultSizeWidth), /* Dispatched Stack Routine Parameter offsets */
  298.     kDispatchedParameterPhase    = (kCallingConventionWidth + kResultSizeWidth + kDispatchedSelectorSizeWidth), /* Special Case offsets & widths */
  299.     kSpecialCaseSelectorWidth    = 6,
  300.     kSpecialCaseSelectorPhase    = kCallingConventionWidth,
  301.     kSpecialCaseSelectorMask    = 0x03F0
  302. };
  303.  
  304. #endif
  305. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  306.  
  307. enum {
  308.     kSpecialCase                = 0x000F                        /* (CallingConventionType) */
  309. };
  310.  
  311.  
  312. enum {
  313.                                                                 /* all of the special cases enumerated.  The selector field is 6 bits wide */
  314.     kSpecialCaseHighHook        = 0,
  315.     kSpecialCaseCaretHook        = 0,                            /* same as kSpecialCaseHighHook */
  316.     kSpecialCaseEOLHook            = 1,
  317.     kSpecialCaseWidthHook        = 2,
  318.     kSpecialCaseTextWidthHook    = 2,                            /* same as kSpecialCaseWidthHook */
  319.     kSpecialCaseNWidthHook        = 3,
  320.     kSpecialCaseDrawHook        = 4,
  321.     kSpecialCaseHitTestHook        = 5,
  322.     kSpecialCaseTEFindWord        = 6,
  323.     kSpecialCaseProtocolHandler    = 7,
  324.     kSpecialCaseSocketListener    = 8,
  325.     kSpecialCaseTERecalc        = 9,
  326.     kSpecialCaseTEDoText        = 10,
  327.     kSpecialCaseGNEFilterProc    = 11,
  328.     kSpecialCaseMBarHook        = 12
  329. };
  330.  
  331. /*
  332.     NOTES ON USING ROUTINE DESCRIPTOR FUNCTIONS
  333.     
  334.     When calling these routine from classic 68k code there are two possible intentions.
  335.  
  336.     The first is source compatibility with code ported to CFM (either PowerPC or 68k CFM). When
  337.     the code is compiled for CFM the functions create routine descriptors that can be used by
  338.     the mixed mode manager operating on that machine. When the code is compiled for classic 68k
  339.     these functions do nothing so that the code will run on Macintoshes that do not have a
  340.     mixed mode manager. The dual nature of these functions is achieved by turning the CFM calls
  341.     into "no-op" macros for classic 68k: You can put "NewRoutineDescriptor" in your source,
  342.     compile it for any runtime or instruction set architecture, and it will run correctly on the
  343.     intended runtime/instruction platform. All without source changes and/or conditional source.
  344.     
  345.     The other intention is for code that "knows" that it is executing as classic 68k runtime
  346.     and is specifically trying to call code of another architecture using mixed mode. Since the
  347.     routines were designed with classic <-> CFM source compatibility in mind this second case
  348.     is treated special. For classic 68k code to create routines descriptors for use by mixed mode
  349.     it must call the "Trap" versions of the routines (NewRoutineDescriptorTrap). These versions
  350.     are only available to classic 68k callers: rigging the interfaces to allow calling them
  351.     from CFM code will result in runtime failure because no shared library implements or exports
  352.     the functions.
  353.     
  354.  
  355.     This almost appears seamless until you consider "fat" routine descriptors and the advent of
  356.     CFM-68K. What does "fat" mean? CFM-68K is not emulated on PowerPC and PowerPC is not emulated
  357.     on CFM-68K. It makes no sense to create a routine descriptor having both a CFM-68K routine
  358.     and a PowerPC native routine pointer. Therefore "fat" is defined to be a mix of classic and
  359.     CFM for the hardware's native instruction set: on PowerPC fat is classic and PowerPC native,
  360.     on a 68k machine with CFM-68K installed fat is classic and CFM-68K.
  361.     
  362.     By definition fat routine descriptors are only constructed by code that is aware of the 
  363.     architecture it is executing as and that another architecture exists. Source compatibility
  364.     between code intented as pure classic and pure CFM is not an issue and so NewFatRoutineDescriptor
  365.     is not available when building pure classic code.
  366.     
  367.     NewFatRoutineDescriptorTrap is available to classic code on both PowerPC and CFM-68K. The
  368.     classic code can use the code fragment manager routine "FindSymbol" to obtain the address of 
  369.     a routine in a shared library and then construct a routine descriptor with both the CFM routine 
  370.     and classic    routine.
  371. */
  372. #if GENERATINGCFM
  373. extern pascal UniversalProcPtr NewRoutineDescriptor(ProcPtr theProc, ProcInfoType theProcInfo, ISAType theISA);
  374.  
  375. extern pascal void DisposeRoutineDescriptor(UniversalProcPtr theProcPtr);
  376.  
  377. extern pascal UniversalProcPtr NewFatRoutineDescriptor(ProcPtr theM68kProc, ProcPtr thePowerPCProc, ProcInfoType theProcInfo);
  378.  
  379. #else
  380. extern pascal UniversalProcPtr NewRoutineDescriptorTrap(ProcPtr theProc, ProcInfoType theProcInfo, ISAType theISA)
  381.  TWOWORDINLINE(0x7000, 0xAA59);
  382.  
  383. extern pascal void DisposeRoutineDescriptorTrap(UniversalProcPtr theProcPtr)
  384.  TWOWORDINLINE(0x7001, 0xAA59);
  385.  
  386. extern pascal UniversalProcPtr NewFatRoutineDescriptorTrap(ProcPtr theM68kProc, ProcPtr thePowerPCProc, ProcInfoType theProcInfo)
  387.  TWOWORDINLINE(0x7002, 0xAA59);
  388.  
  389. #define DisposeRoutineDescriptor(theProcPtr)
  390. #define NewRoutineDescriptor(theProc, theProcInfo, theISA) ((UniversalProcPtr)theProc)
  391. /* Note that the call to NewFatRoutineDescriptor is undefined when GENERATINGCFM is false. */
  392. #endif
  393. #if GENERATINGCFM
  394. /*
  395.  CallUniversalProc is only implemented in shared libraries on 68k and PowerPC, it is now
  396.  conditionalize with GENERATINGCFM.  This will catch accidental calls from classic 68K code
  397.  that previously only showed up as linker errors.
  398. */
  399. extern long CallUniversalProc(UniversalProcPtr theProcPtr, ProcInfoType procInfo, ...);
  400.  
  401. extern long CallOSTrapUniversalProc(UniversalProcPtr theProcPtr, ProcInfoType procInfo, ...);
  402.  
  403. #endif
  404. #endif
  405. /* Macros for building ProcInfos */
  406. /*
  407.  * * * * * * * * * * * * * * 
  408.  *    SIZE_CODE -     Return the size code for an object, given its size in bytes.
  409.  *        size - size of an object in bytes
  410. */
  411. #define SIZE_CODE(size) \
  412.     (((size) == 4) ? kFourByteCode : (((size) == 2) ? kTwoByteCode : (((size) == 1) ? kOneByteCode : 0)))
  413. /*
  414.  * * * * * * * * * * * * * * 
  415.  *    RESULT_SIZE -     Return the result field of a ProcInfo, given the return object’s size.
  416.  *                     This is the same for all ProcInfos
  417.  *        sizeCode - size code
  418. */
  419. #define RESULT_SIZE(sizeCode) \
  420.     ((ProcInfoType)(sizeCode) << kResultSizePhase)
  421. /*
  422.  * * * * * * * * * * * * * * 
  423.  *    STACK_ROUTINE_PARAMETER -    Return a parameter field of a ProcInfo, for a simple,
  424.  *                                non-dispatched, stack based routine.
  425.  *        whichParam - which parameter
  426.  *        sizeCode - size code
  427. */
  428. #define STACK_ROUTINE_PARAMETER(whichParam, sizeCode) \
  429.     ((ProcInfoType)(sizeCode) << (kStackParameterPhase + (((whichParam) - 1) * kStackParameterWidth)))
  430. /*
  431.  * * * * * * * * * * * * * * 
  432.  *    DISPATCHED_STACK_ROUTINE_PARAMETER -    Return a parameter field of a ProcInfo, for 
  433.  *                                            a dispatched, stack based routine.  The same
  434.  *                                            macro is used regardless of the type of
  435.  *                                            dispatching.
  436.  *        whichParam - which parameter
  437.  *        sizeCode - size code
  438. */
  439. #define DISPATCHED_STACK_ROUTINE_PARAMETER(whichParam, sizeCode) \
  440.     ((ProcInfoType)(sizeCode) << (kDispatchedParameterPhase + (((whichParam) - 1) * kStackParameterWidth)))
  441. /*
  442.  * * * * * * * * * * * * * * 
  443.  *    DISPATCHED_STACK_ROUTINE_SELECTOR_SIZE -    Return a the selector size field of a ProcInfo
  444.  *                                                for a dispatched, stack based routine.  The
  445.  *                                                same macro is used regardless of the type of
  446.  *                                                dispatching.
  447.  *        sizeCode - size code 
  448. */
  449. #define DISPATCHED_STACK_ROUTINE_SELECTOR_SIZE(sizeCode) \
  450.     ((ProcInfoType)(sizeCode) << kDispatchedSelectorSizePhase)
  451. /*
  452.  * * * * * * * * * * * * * * 
  453.  *    REGISTER_RESULT_LOCATION -        Return the Result Location field of a ProcInfo, 
  454.  *                                    given the location.
  455.  *        whichReg - which register
  456. */
  457. #define REGISTER_RESULT_LOCATION(whichReg) \
  458.     ((ProcInfoType)(whichReg) << kRegisterResultLocationPhase)
  459. /*
  460.  * * * * * * * * * * * * * * 
  461.  *    REGISTER_ROUTINE_PARAMETER -    Return a parameter field of a ProcInfo for a 
  462.  *                                    register based routine.
  463. */
  464. #define REGISTER_ROUTINE_PARAMETER(whichParam, whichReg, sizeCode) \
  465.     ((((ProcInfoType)(sizeCode) << kRegisterParameterSizePhase) | ((ProcInfoType)(whichReg) << kRegisterParameterWhichPhase)) << \
  466.             (kRegisterParameterPhase + (((whichParam) - 1) * kRegisterParameterWidth)))
  467. /*
  468.  * * * * * * * * * * * * * * 
  469.  *
  470.  *    SPECIAL_CASE_PROCINFO -     Returns the procInfo constant for the following special cases:
  471.  *    
  472.  *        High Hook & Caret Hook -  (see I-379)
  473.  *            C calling conventions, Rect on stack, pointer in A3, no return value
  474.  *        EOL Hook - (see VI-15-26)
  475.  *            Register-based; inputs in D0, A3, A4; 
  476.  *            output is Z flag of status register
  477.  *        Width Hook - (see VI-15-27)
  478.  *            Register-based; inputs in D0, D1, A0, A3, A4; output in D1 
  479.  *        NWidth Hook - (see VI-15-27)
  480.  *            Register-based; inputs in D0, D1, D2, A0, A2, A3, A4; output in D1 
  481.  *        TextWidthHook - (see VI-15-28)
  482.  *            Register-based; inputs in D0, D1, A0, A3, A4; output in D1 
  483.  *        DrawHook - (see VI-15-28)
  484.  *            Register-based; inputs in D0, D1, A0, A3, A4; no output
  485.  *        HitTestHook - (See VI-15-29)
  486.  *            Register-based; inputs in D0, D1, D2, A0, A3, A4; outputs in D0, D1, D2
  487.  *        FindWord -  (see VI-15-30)
  488.  *            Register-based; inputs in D0, D2, A3, A4; outputs in D0, D1
  489.  *        ADBRoutines - (see V-371)
  490.  *            Register-based; inputs in A0, A1, A2, D0; no outputs
  491.  *        ProtocolHandler - (see II-326)
  492.  *            Register-based; inputs in A0, A1, A2, A3, A4, D1.w; output in Z 
  493.  *        SocketListener - (see II-329)
  494.  *            Register-based; inputs in A0, A1, A2, A3, A4, D0.b, D1.w; output in Z 
  495.  *        Reclac - (see I-391)
  496.  *            Register-based; inputs in A3, D7; outputs in D2, D3, D4
  497.  *        DoText - (see I-391)
  498.  *            Register-based; inputs in A3, D3, D4, D7; outputs in A0, D0
  499.  *        GNEFilterProc - (see tech note 85)
  500.  *            Register & Stack Based; inputs in A1, D0 & on the stack; outputs on the stack
  501.  *        MenuBarHook - (see I-356)
  502.  *            Register & Stack Based; input on the stack; output in D0
  503. */
  504. #define SPECIAL_CASE_PROCINFO(specialCaseCode)            \
  505.         (kSpecialCase | ((ProcInfoType)(specialCaseCode) << 4))
  506.  
  507. #if PRAGMA_ALIGN_SUPPORTED
  508. #pragma options align=reset
  509. #endif
  510.  
  511. #if PRAGMA_IMPORT_SUPPORTED
  512. #pragma import off
  513. #endif
  514.  
  515. #ifdef __cplusplus
  516. }
  517. #endif
  518.  
  519. #endif /* __MIXEDMODE__ */
  520.  
  521.